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Foreword 



id , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

TS 32.411: "Performance Management (PM) Integration Reference Point (IRP): Requirements"; 

TS 32.412: "Performance Management (PM) Integration Reference Point (IRP): Information Service 

(IS)"; 

TS 32.413: "Performance Management (PM) Integration Reference Point (IRP): Common Object Request 

Broker Architecture (CORBA) Solution Set (SS)"; 

TS 32.414: "Performance Management (PM) Integration Reference Point (IRP): Common Management 

Information Protocol (CMIP) Solution Set (SS)". 

The present document is part of a set of TSs which describes the requirements and information model necessary for the 
Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

A 3G system is composed of a multitude of Network Elements (NE) of various types and, typically, different vendors, 
which inter-operate in a co-ordinated manner in order to satisfy the network users' communication requirements. 
Any evaluation of PLMN-system behaviour will require performance data collected and recorded by its NEs according 
to a schedule established by the EM. 

This aspect of the management environment is termed Performance Management. The purpose of any Performance 
Management activity is to collect performance related data, which can be used to locate potential problems in the 
network. 
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Scope 



The present document specifies the Information Service for the Performance Management Integration Reference Point 
(PM IRP) as it applies to the Itf-N. 

This IRP IS defines the semantics of operations (and their parameters) visible across the Itf-N in a protocol and 
technology neutral way. It does not define the syntax or encoding of the operations and their parameters. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] ITU-T Recommendation X.721 (1992): "Information technology - Open Systems Interconnection - 

Structure of management information: Definition of management information". 

[4] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault management; Part 2: Alarm 

Integration Reference Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[6] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[7] 3GPP TS 32.401: "Telecommunication management; Performance Management (PM); Concept 

and Requirements". 

[8] 3GPP TS 32.41 1: "Telecommunication management; Performance Management (PM) Integration 

Reference Point (IRP): Requirements". 

[9] 3GPP TS 32.602: "Telecommunication management; Configuration Management (CM); Basic CM 

Integration Reference Point (IRP): Information Service (IS)". 

[10] 3GPP TS 32.342: "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP): Information Service (IS)". 

[II] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 
convention for Managed Objects". 

[12] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[13] Void. 

[14] 3GPP TS 32.403: "Telecommunication management; Performance Management (PM); 

Performance measurements - UMTS and combined UMTS/GSM". 
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[15] 



3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 
and definitions". 



Definitions and abbreviations 



3.1 



Definitions 



For the purposes of the present document, the terms and definitions defined in 3GPP TS 32.41 1 [8] and 
3GPP TS 32.401 [7] apply. 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CMIP Common Management Information Protocol 

CMIS Common Management Information Service 

CORBA Common Object Request Broker Architecture 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

NE Network Element 

NM Network Manager 

NRM Network Resource Model 

PM Performance Management 

PMIRP Performance Management Integration Reference Point 

UML Unified Modelling Language 



ETSI 



3GPP TS 32.412 version 6.9.0 Release 6 



10 



ETSI TS 132 412 V6.9.0 (2006-12) 



4 System Overview 

4.1 System Context 

The general definition of the System Context for the present IRP is found in 3GPP TS 32.150 [15] subclause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in the two diagrams below. 
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Figure 4.1 : System Context A 
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Figure 4.2: System Context B 



4.2 Compliance rules 



For general definitions of compliance rules related to qualifiers (Mandatory/Optional/Conditional) for operations, 
notifications and parameters (of operations and notifications) please refer to 3GPP TS 32.102 [2]. 



Void 
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6 Information Object Classes (lOCs) 

6.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [6], information object class, Top 


Top 


3GPP TS 32.622 [6], information object class, IRPAgent 


IRPAgent 


3GPP TS 32.312 [5], information object class, ManagedGenericIRP 


ManagedGenericIRP 


3GPP TS 32.602 [9], information object class, Managed Entity 


Managed Entity 


3GPP TS 32.302 [12], information object class, NotificationIRP 


NotificationIRP 


3GPP TS 32.1 1 1 -2 [4], information object class, AlarmIRP 


AlarmIRP 


3GPP TS 32.342 [10], information object class, FileTransferIRP 


FileTransferIRP 



6.2 Class diagram 

6.2.1 Attributes and relationships 

This clause introduces the set of Information Object Classes (IOCs) that encapsulate information within the 
IRPAgent. The intent is to identify the information required for the PMIRP Agent implementation of its operations 
and notification emission. This clause provides the overview of all support object classes in UML. Subsequent clauses 
provide more detailed specification of various aspects of these support object classes. 
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Figure 6.2.1(a): Information Object Class UML Diagram - Measurement 
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Figure 6.2.1(b): Information Object Class UML Diagram - Thresholding 
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Figure 6.2.1(c): Information Object Class UML Diagram - Combined 
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information Object Class» 
ManagedGene ricIRP 
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Figure 6.2.2: Information Object Class Inheritance UML Diagram 
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6.3 Information Object Class (lOCs) definitions 



6.3.1 MeasurementJob 



6.3.1.1 



Definition 



It represents a task that monitors and collects the performance measurement data, i.e. values of multiple 
measurementTypes of multiple ManagedEnt ity instances, at regular time intervals defined in 

JobMeasurement Schedule. 

The target measurementTypes are those measurementTypes, whose names are in the related MeasuredAttribute . 
measurementTypeName, of the related ManagedEntity instances. The attributes of Measurement Job, 
JobMeasurementSchedule and MeasuredAttribute can not be modified (except jobStatus) once a 
measurement job is created. 

The MeasurementJob shall use its information and the information of the related JobMeasurementSchedule 
and the information of MeasuredAttribute(s) to perform measurement data collection during the 
MeasurementJob life-time. At the time of data collection, if Measurement Job suspects the validity of the 
collected monitored values, the MeasurementJob should convey the fact to the IRPManager using the suspectFlag 
(3GPP TS 32.401 [7]) of the Report. The MeasurementJob will not emit any notification about this fact. 
Furthermore, the MeasurementJob shall continue to monitor the same target measurementTypes. Even in the worst 
possible case when the MeasurementJob cannot collect a single value from the target measurementTypes, the 
MeasurementJob must continue its activities according to the schedule created at MeasurementJob creation 
time. 

The PMIRP Agent may decide to stop a MeasurementJob because of a PMIRP Agent internal problem or other 
problems such as in the case when the related managed resource is not accessible (e.g. uninstalled) or there exist a 
prolonged communication link problem between the PMIRP Agent and the related managed resource. In such case, the 
PMIRP Agent can stop the MeasurementJob resulting in the MeasurementJob . jobStatus == "Stopped". 
Additionally, " notifyMeasurementJobStatusChanged" notification shall be emitted to notify all subscribed 
IRPManagers about the stopping of a MeasurementJob. 

The PMIRP Agent may also selectively suspend one or more MeasurementJobs without any operator's action in case of 
overload. In such case, the PMIRP Agent suspends all the chosen MeasurementJob(s) resulting in the 
MeasurementJob.jobStatus == 'Suspended' and emit 'notifyMeasurementJobStatusChanged' notification for each 
MeasurementJob to notify all subscribed IRPManager(s) about the suspension. The behaviour on threshold monitors of 
PMIRP Agent after suspending is the same as the one after calling suspendMeasurementJob. 

Then it should be possible, at any time, for the operator to resume a MeasurementJob suspended by the system. PMIRP 
agent may also resume the measurementJob by itself after detecting the end of the overload. When PMIRP Agent does 
not support the resumeMeasurementJob operation, PMIRP Agent shall resume the measurementJob automatically after 
detecting the end of overload. The behaviour of PMIRP Agent after resuming the measurementJob is the same as the 
one after calling resumeMeasurementJob. PMIRP Agent may suspend the corresponding measurementJob(s) when it can 
decide which one/ones cause(s) the overload; otherwise, PMIRP Agent can take jobPriority as a reference. The criterion 
for suspending one or another measurementJob of equal job priority is vendor specific. 

The way to detect the beginning and the end of overload is out of the scope of the present document. 



6.3.1.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobld 


+ 


M 


M 


- 


jobGranularityPeriod 


+ 


M 


M 


- 


jobReportingPeriod 


+ 


M 


M 


- 


jobStatus 


+ 


M 


M 


- 


jobPriority 


+ 





M 


- 
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6.3.1.3 



State diagram 



The measurement I 
job is visible via Itf-N 



create 



stopMeasurementJob 
or stopped by system 




The measurement job is 
visible via Itf-N and not 
removed in IRPAgent 



Stopped 



stopTime reached or 

stopMeasurementJob or 
suspendMeasur^mehtJob st0 ^> by system 



7T 



stopTime reached or 

stopMeasurementJob or 

.. ,.\ stopped by system 

resumeMeasurementJob^ 

and startTimejeached 



The measurement L 
job is removed in 
IRPAgent 



suspendMeasurementJob 
or suspended by system 



Active 



Figure 6.3.1.3.1 : State Diagram for Measurement Job 



Active 



Busy 



schedule, reached 
schedule ended 
Idle 




Figure 6.3.1.3.2: SubState Diagram of Active 

The detailed description and state transition scenarios for Measurement Job are in annex A. 

6.3.2 JobMeasurementSchedule 



6.3.2.1 



Definition 



JobMeasurementSchedule is the representation of the time intervals when the measurement job monitors and 
collects the performance measurement data. The attributes of JobMeasurementSchedule can not be modified 
once a measurement job is created. 
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6.3.2.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobStartTime 


+ 


M 


M 


- 


jobStopTime 


+ 


M 


M 


- 


jobSchedule 


+ 


M 


M 


- 



6.3.3 PMIRP 



6.3.3.1 



Definition 



PMIRP is the representation of the performance management capabilities specified by the present document. This IOC 
inherits from ManagedGenericIRP IOC specified in 3GPP TS 32.312 [5]. 

6.3.3.2 Attribute 

There is no additional attribute defined for this IOC besides those inherited. 



6.3.3.3 



Notification 



Name 


Qualifier 


Notes 


notifyMeasurementJobStatusChanged 


M 


See clause 7.6.1. 


notifyThresholdMonitorObjectCreation 


M (see note) 


See clause 7.7.1. 


notifyThresholdMonitorObjectDeletion 


M (see note) 


See clause 7.7.2. 


notifyThresholdMonitorStatusChanged 


(see note) 


See clause 7.7.3. 


NOTE: This notification is defined within the PMIRPNotification_2 Interface (see clause 7.7) which is qualified as 
optional. 

If the Interface is supported, then the qualifier defined here is relevant. 
Otherwise, the qualifier is irrelevant. 



6.3.4 Measurement JobList 



6.3.4.1 



Definition 



Measurement JobList is the representation of the list of Measurement Jobs. 



6.3.4.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobListld 


+ 


M 


M 


- 



6.3.5 MeasuredAttribute 



6.3.5.1 



Definition 



It represents the name of the measurementType of the related ManagedEntity instance whose value is to be 
monitored and collected. The name of the monitored and collected measurementType is captured by 
measurementTypeName. 



6.3.5.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


measurementTypeName 


+ 


M 


M 


- 
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6.3.6 MeasurementReader 



6.3.6.1 



Definition 



It represents the capability to read the value of the measurementType of the related ManagedEntity instance. 
The value of the monitored and collected measurementType is captured by measurementResultValue. 



6.3.6.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


measurementResultValue 


+ 


M 


M 


- 


probableCause 


+ 


M 


M 


- 


specificProblem 


+ 


M 


M 


- 


direction 


+ 


M 


M 


- 



6.3.7 ManagedEntity 



6.3.7.1 



Definition 



The IOC ManagedEntity represents the role that can be played by an instance of an IOC defined in Network 
Resources Models, e.g. Generic Network Resource Model, Core Network Resource Model, UTRAN Network Resource 
Model or GERAN Network Resource Model. It also represents the role that can be played by an instance of VSE 
subclass of 3GPP defined NRM IOCs or VSE defined NRM IOCs. ManagedEntity is used in the specification of 
PMIRP operations to represent an instance of an IOC defined in these Network Resource Models. 

6.3.8 Monitor 



6.3.8.1 



Definition 



It represents a capability to determine the (a) threshold-crossing or (b) threshold-reaching and the threshold-clearing. 
This class is abstract in that it cannot be instantiated. The ThresholdMonitor inherits this class. 

It is the IRPAgent"s choice to support (a) or (b) (but not both). The support is on an IRP Agent system wide basis and is 
not on a per threshold basis. The IRPAgent"s behaviour regarding which approach (i.e., (a) or (b) above) to use, shall be 
the same for emitting alarms and for clearing alarms. 

The instances of a class derived from this abstract class shall emit notifyThresholdMonitorObjectCreation when they 
are first created; and shall emit a notifyThresholdMonitorObjectDeletion when deleted. 

The instances of a class derived from this abstract class shall also emit notifyNewAlarm, notifyChangedAlarm and 
notifyClearedAlarm according to the rules specified in Annex B: Threshold Alarm Triggering Events. 
The ob jectClass and ob jectlnstance parameter of these notifications carry the class and DN of the 
ManagedEntity whose measurementType is being monitored and whose threshold condition has been triggered. 
The eventType of these notifications carry "Quality of Service Alarm". See 3GPP TS 32.111-2 [4]. 



6.3.8.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


monitorld 


+ 


M 


M 


- 


monitorGranularityPeriod 


+ 


M 


M 


- 



6.3.8.3 



Notification 



Notification name 


Note 


notifyThresholdMonitorCreation 


See clause 7.1 (class diagram). 


notifyThresholdMonitorDeletion 


See clause 7.1 (class diagram). 
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6.3.9.1 Definition 

ThresholdMonitorList is the representation of the list of ThresholdMonitors. 

6.3.9.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


monitorListld 


+ 


M 


M 


- 



6.3.10 ThresholdMonitor 



6.3.10.1 



Definition 



In order to monitor the overall health of the network, the thresholds are set by the authorized users to generate network 
performance related alarms. The ThresholdMonitor contains the values of the threshold settings for the PM 
parameters. If the threshold is (a) crossed or (b) reached (see 6.3.8.1 for clarification of the alternatives (a) and (b)), a 
performance alarm will be emitted (see 3GPP TS 32.401 [7]). The name of the monitored measurementType is captured 
by MeasuredAt tribute .measurementTypeName and the value of it is captured by 
Measurement Reader .measurement Re sultValue. 



6.3.10.2 



Attribute 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


thresholdMonitorStatus 


+ 


M 


M 


- 



6.3.11 ThresholdLevel 



6.3.11.1 



Definition 



It defines the thresholding criteria (via ThresholdLevel . thresholdValue and 

ThresholdLevel . hysteresis) for a measurementType. It also specifies the thresholdSeverity level (via 
ThresholdLevel . thresholdSeverity) carried in the alarm triggered by the (a) threshold crossing or (b) 
threshold reaching event. (See 6.3.8.1 for clarification of the alternatives (a) and (b)). 



6.3.11.2 



Attribute 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


thresholdValue 


+ 


M 


M 


- 


thresholdSeverity 


+ 


M 


M 


- 


hysteresis 


+ 


M 


M 


- 



6.4 Information relationship definitions 

6.4.1 relation-pmlRP-measurementJobList (M) 
6.4.1.1 Definition 

This represents the relationship between PMIRP and Measurement JobList. 
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6.4.1.2 



Role 



Name 


Definition 


theMeasurementJobList 


It represents the Measurement JobList. 


thePMIRP 


It represents the pmirp. 



6.4.1.3 Constraint 



Name 



Definition 



uniqueJobListld 



The jobListlds playing the role of theMeasurementJobList, are unique within a particular pmirp. 



6.4.2 relation-measurementJobList-measurementJob (M) 

6.4.2.1 Definition 

This represents the relationship between Measurement JobList and Measurement Job. 

6.4.2.2 Role 



Name 


Definition 


theMeasurementJob 


It represents the Measurement Job. 


theMeasurementJobList 


It represents the Measurement JobList. 



6.4.2.3 Constraint 



Name 



Definition 



uniqueJobld 



The joblds of all Measurement Jobs, playing the role of theMeasurementJob, are 
unique within a particular PMIRP and Measurement JobList. 



6.4.3 relation-measurementJob-jobMeasurementSchedule (M) 

6.4.3.1 Definition 

This represents the relationship between Measurement Job and JobMeasurementSchedule. 

6.4.3.2 Role 



Name 


Definition 


theJobSchedule 


It represents the JobMeasurementSchedule. 


theMeasurementJob 


It represents the Measurement Job. 



6.4.4 relation-measurementJob-measurement (M) 
6.4.4.1 Definition 

This represents the relationship between Measurement Job and MeasurementReader. 
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6.4.4.2 



Role 



Name 


Definition 


theMeasurement 


It represents the MeasurementReader. 


theMeasurementJob 


It represents the Measurement Job. 



6.4.5 relation-measured Attribute-managed Entity (M) 
6.4.5.1 Definition 

This represents the relationship between MeasuredAttribute and ManagedEntity. 



6.4.5.2 



Role 



Name 


Definition 


theMeasuredAttribute 


The MeasuredAttribute, when playing this role, reads the monitored measurement types 
of the related ManagedEntity instances. The names of measurement types are captured by 
the MeasuredAttribute. MeasurementTypeName . When playing this role, the 
MeasuredAttribute is aware of the class name and DN of the ManagedEntity. 


theME 


The ManagedEntity, when playing this role, represents the actual network resource 
instance under measurement or whose measurementTypes are being monitored for (a) 
threshold-crossing or (b) threshold-reaching and threshold-clearing. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 



6.4.5.3 



Constraint 



Name 


Definition 


applyToSameObjectClass 


The MeasuredAttribute, which playing the role of "theMeasuredAttribute", can monitor 
the thresholds of the measurementTypes of one or multiple managed object instances of the 
same managed object class, which playing the role of "theME". 



6.4.6 relation-pmlRP-thresholdMonitorList (M) 
6.4.6.1 Definition 

This represents the relationship between PMIRP and ThresholdMonitorList. 



6.4.6.2 



Role 



Name 


Definition 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 


thePMIRP 


It represents the pmirp. 



6.4.6.3 Constraint 



Name 



Definition 



uniqueMonitorListld 



The monitorListlds playing the role of theThresholdMonitorList, are unique within a particular 

PMIRP. 
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6.4.7 relation-thresholdMonitorList-thresholdMonitor (M) 
6.4.7.1 Definition 

This represents the relationship between ThresholdMonitorList and ThresholdMonitor. 



6.4.7.2 



Role 



Name 


Definition 


theThresholdMonitor 


It represents the ThresholdMonitor. 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 



6.4.7.3 



Constraint 



Name 



Definition 



uniqueMonitorld 



The monitorlds of all ThresholdMonitors, playing the role of theThresholdMonitor, are unique 
within a particular ThresholdMonitorList. 



6.4.8 relation-thresholdMonitor-measurement (M) 
6.4.8.1 Definition 

This represents the relationship between ThresholdMonitor and MeasurementReader. 



6.4.8.2 



Role 



Name 


Definition 


theMeasurement 


It represents the MeasurementReader. 


theThresholdMonitor 


It represents the ThresholdMonitor. 



6.4.9 relation-measuredAttribute-thresholdLevels (M) 
6.4.9.1 Definition 

This represents the relationship between MeasuredAttribute and ThresholdLevel. 



6.4.9.2 



Role 



Name 


Definition 


theMeasuredAttribute 


The MeasuredAttribute, when playing this role, can have 1 ..4 ThresholdLevel associates 
with it to set the (a) threshold-crossing or (b) threshold reaching and the clearing criteria 
(i.e. ThresholdLevel . thresholdValue, ThresholdLevel . hysteresis) and associated 
thresholdSeverity (i.e. ThresholdLevel . thresholdSeverity) of the monitored 
measurementType. (see 6.3.8.1 for clarification of the alternatives (a) and (b)) 


theThresholdLevel 


When playing this role, the ThresholdLevel captures the (a) threshold-crossing or (b) 
threshold-reaching and the threshold-clearing criteria and its associated thresholdSeverity level, 
(see 6.3.8.1 for clarification of the alternatives (a) and (b)) 



6.4.9.3 



Constraint 



Name 



Definition 



noMoreThanFourLevels 



A MeasuredAttribute may have no more than four ThreshoidLeveis associated with it. 
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6.5 



Information attribute definition 



6.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


direction 


For some measurementType, the higher its 
thresholdValue, the higher is the thresholdSeverity. 
For others, the lower its thresholdValue, the higher 
is its thresholdSeverity. This attribute identifies if 
the measurementType is of the former 
(i.e. "Increasing") or latter type (i.e. "Decreasing"). 
If it is "Increasing", the threshold event is triggered 
when the value first equals or exceeds (when 
compared against the last read value) a threshold 
value. The threshold is said to be cleared when the 
measurementType value falls below (when 
compared against the last read value) one or more 
threshold values. 

If it is "Decreasing", the threshold event is 
triggered when the measurementType value first 
equals or falls below one or more threshold values. 
The threshold is said to be cleared when the 
measurementType value rises above the threshold 
value. 

See annex B (Threshold Related Performance 
Alarm Triggering Events) for details of the 
behaviour of multiple thresholds. 


Possible values are: "Increasing", 
"Decreasing" 


hysteresis 


A threshold has a value. It can have a hysteresis. 
A threshold with a hysteresis has a threshold-high 
and a threshold-low value that are different from 
the threshold value. 

A hysteresis, therefore, defines the threshold-high 
and threshold-low levels within which the 
measurementType value is allowed to oscillate 
without triggering a (a) threshold-crossing or (b) 
threshold-reaching or a threshold-clearing 
condition. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 
threshold-high = threshold + hysteresis 
threshold-low = threshold - hysteresis 
See annex B (Threshold Related Performance 
Alarm Triggering Events). 


Any positive value 


jobGranularityPeriod 


It specifies the period between two successive 
measurements. 


The value can be 5 minutes, 15 
minutes, 30 minutes, 1 hours, 12 hours 
and 24 hours. 

The minimum granularity period is 5 
minutes in most cases, but for some 
measurements it may only make sense 
to collect data in a larger granularity 
period. 


jobld 


It identifies the Measurement Job instance (and 
distinguishes it from all other existing and stopped 

Measurement Job instances of the pmirp Agent). 


Any identifier except: 

1 . Those that identify 
Measurement Job instances 
whose 

Measurement Job . jobStatus 
( s ) are Scheduled, Active, 
Suspended or Stopped; and 

2. Those that appear in filenames of 
files ready for IRPManager 
retrieval. 


jobListld 


It identifies the Singleton Measurement JobList 
of the pmirp Agent. 


Any identifier. 
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Attribute Name 


Definition 


Legal Values 


jobReportingPeriod 


It specifies the period between two successive 
emissions of notifyFileReady or 
notifyFilePreparationError [10]. The two 
notifications are related to the same Job. See 
constraints reportTime in clause 6.5.2. 


Its value should be one or multiple of 
jobGranularityPeriod. 


jobSchedule 


It specifies the detailed time frames during which 

the Measurement Job . jobStatus = Active and 
its substate = Busy. 


Its value is only one of the following, 
dailyScheduling or weeklyScheduling. 
The legal values for them refer to ITU-T 
Recommendation X.721 [3]. 
The legal values for them are as follows. 
dailyScheduling: 

{{ intervalStart {hour 0, minute 0}, 
intervalEnd {hour 23, minute 59}}} 

weeklyScheduling: 
{{daysOfWeek '1111111'B, 
intervalsOfDay dailyScheduling}} 


jobStartTime 


It specifies the begin time from which the 
Measurement Job will be active. 


All values that indicate valid timestamp. 


jobStatus 


It specifies the Status Of Measurement Job. 


Its value should be one of the following: 

Scheduled, 

Active, 

Suspended 

Stopped 


jobPriority 


It specifies the priority of MeasurementJob 


Its value should be one of the following: 

Low, 

Medium, 

High 


jobStopTime 


It specifies the end time after which the 
MeasurementJob will be Stopped. 


All values that indicate valid timestamp 

and it should be later than 

jobStartTime. It's not necessary that 

jobStartTime and JobStopTime specifies 

time within the same day. 

This attribute may carry the value 

"indefinitely". 


measurementResultValue 


It identifies the value of a measurement type. 


Any valid measurement result value. 


measurementTypeName 


It identifies a name of one measurement type 
whose value is being collected and monitored. 


Any valid measurement type name as 
defined by the measurement definition 
template in 3GPP TS 32.403 [14]. 


monitorGranularityPeriod 


It specifies the period between two successive 
reading of the thresholdValue to determine (a) 
threshold-crossing or (b) threshold-reaching and 
threshold-clearing. (See 6.3.8.1 for clarification of 
the alternatives (a) and (b)) 


It can be 5 minutes, 15 minutes, 

30 minutes, 1 hour, 12 hours or 

24 hours. 

It has to be a multiple of the 

JobGranularityPeriod if the 

MeasurementJob monitoring the same 

imeasurementType exists. 


monitorld 


It identifies the ThreshoidMonitor instance (and 
distinguishes it from all other existing 
ThreshoidMonitor instances of the PMIRP 
Agent). 


Any identifier except those that are 
currently used. 


monitorListld 


It identifies the singleton 

ThresholdMonitorList in the PMIRP Agent. 


Any identifier. 


probableCause 


It identifies the probable cause (of the (a) threshold 
crossing or (b) threshold reaching) carried by the 
threshold crossing or reaching alarm. (See 6.3.8.1 
for clarification of the alternatives (a) and (b)) 


"Threshold Crossed" 


thresholdSeverity 


It identifies the thresholdSeverity of the (a) 
threshold crossing or (b) threshold reaching event. 
(See 6.3.8.1 for clarification of the alternatives (a) 
and (b)) 


Warning, Minor, Major, Critical 


specificProblem 


It identifies the specific problem (causing the (a) 
threshold crossing or (b) threshold reaching) 
carried by the threshold crossing or reaching 
alarm. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 


Any valid specificProblem as defined by 
3GPPTS32.111-2[4]. 
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Attribute Name 


Definition 


Legal Values 


thresholdMonitorStatus 


It specifies the current status of the 
ThresholdMonitor. 


Active - ThresholdMonitor is 

working; 

Suspended - ThresholdMonitor is 

suspended. 


thresholdValue 


It defines the threshold value of the monitored 
measurementTypes. If the value is (a) crossed or 
(b) reached, the performance alarm shall be 
emitted depending on the value of the 

thresholdMonitorStatus. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 


If the monitored measurementType is of 
Gauge type, this thresholdValue shall be 
of the same type. 

If the monitored measurementType is of 
counter type, then this value should be 
expressed as a rate, i.e., the number of 
units of type of the monitored 
measurementType over unit of time. 
Note this rate is independent from the 
monitorGranularityPeriod. This means 
that changes in the 
monitorGranularityPeriod should not 
impact the rate used for threshold 
monitoring. 



6.5.2 Constraints 



Name 


Definition 


firstReportTime 


If the jobReportingPeriod is n times the jobGranularityPeriod, then the first report time shall 
be immediately after the completion of the n-th successful measurementType reading. 


imeasurementTypeReadTi 
mes 


The measurementType reading times are determined by the following rules. 
If JobGranularityPeriod is 5 minutes, then read on every 5 th minute of the hour. 

- If JobGranularityPeriod is 1 5 minutes, then read on every 1 5 th minute of the hour. 

- If JobGranularityPeriod is 30 minutes, then read on every 30 th minute of the hour 

- If JobGranularityPeriod is 1 hour, then read on every hour of the day 

- If JobGranularityPeriod is 12 hours, then the first read shall be as soon as possible on 
the hour and subsequent reads shall be at 12 hours interval. 

- If JobGranularityPeriod is 24 hours, then the first read shall be as soon as possible on 
the hour and subsequent reads shall be at 24 hours interval. 


multiLevelSeverity 
HysteresisOverlap 


For each ThresholdLevel .thresholdSeverity, there may be a 
ThreshoidLevei. hysteresis value corresponding to it. These multi-level values of 
ThresholdLevel. hysteresis, relating to one ThresholdMonitor, shall not overlap. 


multiLevelSeverityOrder 


The multiple ThresholdLevel (s) , related to one ThresholdMonitor, shall be of the 
following order. If ThresholdLevel . thresholdSeverity of one instance is higher 
than that of the other instance and the direction is 'Increasing', then the 
ThresholdLevel . thresholdValue is higher than that of the Other. If 
ThresholdLevel . thresholdSeverity of one instance is higher than that of the other 
instance and the direction is 'Decreasing', then the ThresholdLevel. thresholdValue 
is lower than that of the other. 


numberOfThresholdLevel 
PerThresholdMonitor 


In relation-tMonitor-tLevel, the multiplicity of theThresholdLevel is "1 ..4". 

If pmirp supports multi-level thresholdSeverity, then there are at most 4 

ThresholdLevels relating to one ThresholdMonitor. All 

ThresholdLevel . thresholdSeverity instances shall hold a different value that is 

chosen from the following: 'Critical', 'Major', "Warning' and 'Minor'. 

If pmirp does not support multi-level thresholdSeverity, then there is only one 

ThresholdLevel relating to one ThresholdMonitor. The sole 

ThresholdLevel . thresholdSeverity shall hold one of the following: 'Critical', 

'Major', "Warning' or 'Minor'. 
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Interface definition 



7.1 Class diagram 



<<hformationObjectClass» 
NotificationIRP 

(from TS 32.302) 



w 



«Notification» 
PMIRPNotifications 1 



«agent-internal-usage>> 



notifyMeasurementJobStatusChanged() 



I 



«agent-internal-usage» 



«may use» 



«Notification» 
PMIRPNotifications 2 



+ notify ThresholdMonitorStatusChanged() 
+ notify ThresholdMonitorObjectCreation() 
+ notify ThresholdMonitorObjectDeletionQ 



«lnformationObjectClass» 
PMIRP 



«may realize» 




« lnterface» 
PMIRPOperations_1 

+ create MeasurementJobO 
+ stopMeasurementJobO 
' + suspendMeasurementJobQ 
+ resumeMeasurementJobO 
+ listMeasurementJobsO 



« Interface » 
PMIRPOperafons_2 



«may realize» 
«agent-internal-usage» «agent-internal-usage» 



«lnformationObjectClass» 
AlarmIRP 

(from TS 32.111) 



«lnformationObjectClass» 
FileTransferIRP 

(fromTS 32.342) 



+ createThresholdMonitorQ 
+ deleteThresholdMonitor() 
+ MstThresholdMonitorsO 



« lnterface» 
PMIRPOperation_3 



+ suspendThresholdMonitor() 
+ resumeThresholdMonitor() 



«may use» 

«Notification>> 
AlarmlRPNotifications_2 

(from TS 32.1 11) 



«use» 

«Notification» 
AlarmlRPNotifications_1 

(fromTS 32.111) 



«use» 



«Notification» 
FileTransferlRPNotifocations_1 

(from TS 32.342) 



« lnterface» 
FileTransferlRPOperations_1 

(from TS 32 342) 



NOTE 1 : PMIRPNotifications_2 is mandatory if PMIRPOperations_2 is supported. 

NOTE 2: The suspendMeasurementJob and resumeMeasurementJob operations are optional. 

Figure 7.1 : Class Diagram 



7.2 



Generic rules 



Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 
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Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 

7.3 PMIRPOperations_1 Interface (M) 
7.3.1 Operation createMeasurementJob (M) 

7.3.1.1 Definition 

This operation supports IRPManager's request to create a Measurement Job through Itf-N. 

Once created, the attributes of Measurement Job (except Measurement Job . jobStatus) and the related 
JobMeasurementSchedule and MeasuredAttribute will not be modified during the life-time of the 

Measurement Job. 

One Measurement Job can collect the value of one or multiple measurementTypes. 

When a measurementType is collected by one Measurement Job for a given instance, another Measurement Job 
which wants to collect the same measurementType for the same instance with different or the same 
jobGranularityPeriod may be rejected. This behaviour shall be consistent for a given implementation by a specific 
vendor. 



ETSI 



3GPP TS 32.412 version 6.9.0 Release 6 



28 



ETSI TS 132 412 V6.9.0 (2006-12) 



7.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


iOCName 


M 


ManagedEntity . ob jectClass 


It specifies one Managed Entity class 
name. iRPManager requests that one 
or more measurementType(s) of the 
instances of this class to be monitored. 


iOCInstanceList 


M 


List of <ManagedEntity . ob ject Instance> 


It specifies the list of DNs of 
ManagedEntity instances whose 
measurementType(s) are to be 
collected. 

ManagedEntity instance(s) can be 
added in the network regardless of 
whether a Measurement Job exists or 
not. 

An empty list means that all instances 
known by pmirp shall be monitored. 
The support of the use of empty list to 
indicate all instances is optional. 
If the Measurement Job is created 
using empty list, there are two possible 
implementations: 

1) pmirp shall monitor all instances 
known by PMIRP at the time of 
MeasurementJob creation, and it will 
not monitor instances added later. 

2) pmirp shall monitor all instances 
known by PMIRP at the time of 
MeasurementJob creation, and it shall 
monitor instances added later. 


measurementCategoryList 


M 


List of < 

MeasuredAttribute . 
measurementTypeName> 


MeasuredAttribute . 
MeasurementTypeName specifies the 
corresponding name of 
measurementType to be measured. 

The element of 

measurementCategoryList could be 
one of the following: 

- The form 

"family. measurementName.subcounter" 
can be used in order to retrieve a 
specified subcounter of a 
MeasurementType. 

- The form 

"family. measurementName" can be 
used in order to retrieve a specific 
MeasurementType. In case the 
MeasurementType includes 
subcounters, all subcounters will be 
retrieved. 

- The form "family" can be used in 
order to retrieve all MeasurementTypes 
in this family. 

At least, one element of 
measurementCategoryList shall be 
specified. 


granularityPeriod 


M 


Measurement Job . jobGranularityPeriod 


See clause 6.5.1 (definition and legal 
values). 
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Parameter Name 


Qualifier 


Information type 


Comment 


reportingPeriod 


M 


Measurement Job . jobReportingPeriod 


See clause 6.5.1 (definition and legal 
values). 

pmirp will periodically monitor the 
performance data according to the 
"reportingPeriod" parameter and 
produces an aggregated report in one 
or more files. These files shall be 
transferred through file transfer 
mechanism covered by the File 
Transfer IRP IS (see TS 32.342 [10]). 


startTime 





JobMeasurementSchedule . jobStartTime 


See clause 6.5.1 (definition and legal 

values). 

Default value is "start now". If startTime 

is in the past, the current time will be 

used and the job will start immediately. 


stopTime 





JobMeasurementSchedule . jobStopTime 


See clause 6.5.1 (definition and legal 

values). 

Default value for JobStopTime is to run 

indefinitely. StopTime shall be later 

than startTime and current time. 


schedule 





JobMeasurementSchedule . jobSchedule 


See clause 6.5.1 (definition and legal 

values). 

Default value is "daily". 


priority 





JobMeasurement Job . jobPriority 


See clause 6.5.1 (definition and legal 

values). 

Default value is 'Medium' 



7.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


jobld 


M 


Measurement Job . jobld 


Unique identifier of the Measurement Job 
from all the existing and stopped 

Measurement Jobs in a PMIRP Agent. 


unsupported List 


M 


List of < 

ManagedEntity .object Instance, 

MeasuredAttribute . 
measurement TypeName, 

reason 
> 


To create a Measurement Job, best-effort 
is required. The parameter of 
'unsupportedList' must be returned if status 
= PartialSuccess. 
The reason can be any of: 
measurementTypeName is unknown to the 

PMIRP. 

measurementTypeName is invalid. 
measurementTypeName is not supported in 
the specific implementation. 
The related IOC Instance is unknown (e.g. it 
does not exist at the time of this operation 
invocation) to the pmirp. 
Insufficient capacity to monitor the related 
IOC Instance(s). 

measurementTypeName is already 
monitored for the IOC instance with the 
same or another granularity period. 
When the input parameter 
iOCInstanceList is empty, the 
unsupportedList shall be empty. 


status 


M 


ENUM (Success, Failure, PartialSuccess) 


An operation may fail because of a specified 
or unspecified reason. 
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7.3.1.4 



Pre-condition 



atLeastOneValidMeasurementType AND validStartTime AND validStopTime AND 
validSchedule AND validGranularityPeriod AND validReportingPeriod AND 
suf f icientCapacity AND validPriority. 



Assertion Name 


Definition 


atLeastOneValidMeasurem 
entType 


At least one input measurementType is valid. The word valid means that the pmirp is 
aware of this measurementType name, is aware of the ManagedEntity holding such 
measurementType and that the Measurement Job created can monitor its value 
according to the monitoring criteria, e.g. granularity period, given in the input parameter. 


validStartTime 


The startTime is valid. 


validStopTime 


The stopTime is valid. 


validSchedule 


The schedule is valid. 


validGranularityPeriod 


The granularityPeriod is valid. 


validReportingPeriod 


The reportingPeriod is valid. 


sufficentCapacity 


The resource of EM and NE can support the requested measurement. 


validPriority 


The priority is valid. 



7.3.1.5 



Post-condition 



someMeasurementTypeNamesMonitored AND 

not if yMeasurement JobStatusChangedMayBeEmitted. 



Assertion Name 


Definition 


someMeasurementTypeNamesMonitored 


At least one input measurementTypeName is monitored by the 
newly created Measurement Job. 


notifyMeasurementJobStatusChangedMayBeEmitted 


If Start time is "Start now", the Measurement Job . jobStatus 
turns "Active" and a notifyMeasurementJobStatusChanged is 
emitted. 



7.3.1.6 



Exceptions 



Exception Name 


Definition 


invalidStartTime 


Condition: validStartTime is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidStopTime 


Condition: validStopTime is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidSchedule 


Condition: validSchedule is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidGranularityPeriod 


Condition: validGranularityPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidReportingPeriod 


Condition: validReportingPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which is one of: 

emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList}, 

{neHDShortage neObjectlnstList}, {neLowMemory, neObjectlnstList}, maxJobReached, 

otherReason; status is set to 'Failure'. 

Exit state: Entry state. 


invalidPriority 


Condition: validPriority is false. 

Returned Information: Name of the exception; status is set to "Failure". 

Exit state: Entry state. 
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7.3.2 Operation stopMeasurementJob (M) 



7.3.2.1 



Definition 



This operation supports IRPManager's request to stop a Measurement Job through Itf-N, after which, the 
Measurement Job may still be visible via Itf-N. Whether the Measurement Job is removed from the managed 
system is vendor specific and out of scope of the present document. 

The behaviour of the IRP Agent when the job is stopped is vendor specific, which means the job could be stopped at the 
end of the GranularityPeriod or immediately. 

After the job has been stopped, the notifyFileReady or notifyFilePreparationError notification shall be emitted 
immediately or when the next reporting period is reached. 



7.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


Jobld 


M 


Measurement Job . jobld 


It specifies the Measurement Job to be Stopped. 



7.3.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


Status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.2.4 



Pre-condition 



measurement JobExists AND measurement JobCanBeStopped. 



Assertion Name 


Definition 


measurementJobExists 


Measurement Job specified in the input parameter exists. 


measurementJobCanBeStopped 


Measurement Job specified in the input parameter can be stopped now. 



7.3.2.5 



Post-condition 



measurement JoblsStopped AND not if yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


measurementJoblsStopped. 


The Measurement Job identified by jobld is stopped but may still be 
visible via Itf-N. The Job state is "Stopped". 


notifyMeasurementJobStatusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 



7.3.2.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (MeasurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


jobCannotBeStopped 


Condition: (measurementJobCanBeStopped) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.3.3 Operation suspendMeasurementJob (O) 



7.3.3.1 



Definition 



This operation supports IRPManager's request to suspend a Measurement Job through Itf-N. When the 
Measurement Job is suspended, the collection of measurement result data by the Measurement Job will stop, 
regardless of its schedule, but the Measurement Job still exists. The suspend operation is necessary in following 
situation: 

High work load experienced by managed system. 

The specified measurement data is not needed in a specific duration. 

Other specific requirement. 

After the job has been suspended, the notifyFileReady or notifyFilePreparationError notification shall be emitted 
immediately or when the next reporting period is reached. 



7.3.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


jobld 


M 


Measurement Job . jobld 


It specifies the Measurement Job to be suspended. 



7.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.3.4 



Pre-condition 



measurement JobExists AND measurement JoblsNotSuspended. 



Assertion Name 


Definition 


measurementJobExists 


The Measurement Job specified in the input parameter exists. 


measurementJoblsNotSuspended 


The Measurement Job specified in the input parameter is not suspended. 



7.3.3.5 



Post-condition 



measurement JoblsSuspended AND notifyThresholdMonitorStatusChangedEmitted AND 

not if yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


MeasurementJoblsSuspe 
nded 


The Measurement Job identified by measurementJobld is suspended. It means the following. 

(a) All files open for capturing measurement results are closed. 

(b) If one of the files closed contain measurement data, a notifyFileReady is emitted 
indicating the availability of the file(s). 

(c) No more reading of measurementType values. 

(d) The Measurement Job . jobstatus is set to 'Suspended'. 

(e) For an IRPAgent using the measurement result data for threshold monitoring, the 
detection of the related performance alarm conditions is suspended. 


notify ThresholdMonitorSt 
atusChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted, if the ThresholdMonitor behaviour is 
dependent on the availability of the measurement result. 


notifyMeasurementJobSta 
tusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 
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7.3.3.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


jobAlreadySuspended 


Condition: (measurementJoblsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.3.4 Operation resumeMeasurementJob (O) 



7.3.4.1 



Definition 



This operation supports IRPManager's request to resume a suspended Measurement Job. When the 
Measurement Job is resumed, it will work according to criteria (e.g. granularity period, startTime, stopTime, 
schedule) set up by the corresponding createMeasurement Job operation. 



7.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


jobld 


M 


Measurement Job . jobld 


It specifies the Measurement Job to be resumed. 



7.3.4.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.4.4 



Pre-condition 



measurementJobExists AND measurement JoblsSuspended AND suf f icientCapacity. 



Assertion Name 


Definition 


measurementJobExists 


Measurement Job specified by the input parameter exists. 


measurementJoblsSuspended 


Measurement Job specified by the input parameter is suspended. 


sufficientCapacity 


The resource of EM and NE can support the requested measurement. 



7.3.4.5 



Post-condition 



measurement Job I sResumed AND not if yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


measurementJoblsResumed 


The Measurement Job identified by MeasurementJobld is resumed., It 
means the following. This resumed Measurement Job shall behave as it 
did when it was first created by createMeasurement Job. 
Depending on the current time and the 

JobMeasurementSchedule . startTime, the 
Measurement Job. jobstatus will be set accordingly. 


notifyMeasurementJobStatusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 
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7.3.4.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


joblsNotSuspended 


Condition: (measurementJoblsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which is one of: 

emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList}, 

{neHDShortage neObjectlnstList}, {neLowMemory, neObjectlnstList}, maxJobReached, 

otherReason; status is set to 'Failure'. 

Exit state: Entry state. 



7.3.5 Operation NstMeasurementJobs (M) 



7.3.5.1 



Definition 



This operation supports IRPManager's request to list the information of all or a set of specified current 

Measurement Jobs. 



7.3.5.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


jobldList 


M 


List of 

<Measurement Job . jobId> 


This parameter specifies the criteria to list the 

Measurement Jobs. 

If the parameter specifies the list of jobld to be retrieved, then 

the corresponding information of jobs will be returned. 

If the parameter contains no information, all the 

Measurement Jobs are retrieved. 



7.3.5.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


joblnfoList 


M 


List of< 

attributes of Measurement Job, 

attributes of 

JobMeasurement Schedule, 

(refer to definition and legal values in 

clause 6.5.1) 

iOCName, 

iOCInstanceList, 

measurementCategoryList 

(refer to input parameter of 

createMeasurementJob in 

clause 7.3.1.2) 

> 


Returned information of corresponding 
Measurement Jobs matching the input criteria. If no 
match, then the length of the joblnfolist will be (with 
status == Success). 

Jobs are created by successful invocation of 
createMeasurementJob (see 7.3.1.2). 

If the job is created using non-empty iocinstanceList 
in createMeasurementJob, then iOCInstanceList 
here shall contain the DNs of the supported IOC 
instances. 

If the job is created using empty iocinstanceList, 
then iocinstanceList here shall be empty as well. 
This case is valid only if IRPAgent support the use of 
empty list, (see clause 7.3.1 .2) 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or 
unspecified reason. 
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7.3.5.4 Pre-condition 

jobldListlsValid. 



Assertion Name 


Definition 


jobldListlsValid 


jobidList specified in the input parameter is valid. 



7.3.5.5 



Post-condition 



measurement JobsAreReturned AND measurement JobNotAf f ected. 



Assertion Name 


Definition 


measurementJobsAreReturned 


The information of required Measurement Jobs are returned in the output parameters. 


measurementJobNotAffected 


The current Measurement Job ( s ) are not affected by the operation. 



7.3.5.6 



Exceptions 



Exception Name 


Definition 


invalidJobldList 


Condition: ( jobldListlsValid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4 PMIRPOperations_2 Interface (O) 
7.4.1 Operation createThresholdMonitor (M) 



7.4.1.1 



Definition 



This operation supports IRPManager's request to create a ThresholdMonitor that defines the thresholds for some 
specific measure mentTypes. If the threshold defined is (a) crossed or (b) reached, the related performance alarms will 
be emitted to subscribed IRPManager ( s ) . 

Two cases are allowed: 

One case only accepts threshold monitoring of measurementType(s) that are already under monitoring by an 
existing Measurement Job. This kind of PMIRP will not monitor a measurementType for (a) threshold- 
crossing or (b) threshold reaching or for clearing if that measurementType is not already subject to a 
Measurement Job monitoring. This kind of PMIRP will only determine the (a) threshold crossing or (b) 
threshold reaching and clearing events when the related Measurement Job ( s ) are in Active states. The 
IRPManager, when interacting with this kind of PMIRP, must first start a Measurement Job to monitor the 
measurementTypes and then invoke this operation for the same measurementTypes. 

The other case is that it can accept threshold monitoring of measurementType(s) regardless if they are already 
under monitoring by existing Measurement Job (s) . ThresholdMonitor is independent of any existing 
Measurement Job(s) and no new Measurement Job(s) are created for threshold monitoring purposes. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
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7.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


iOCName 


M 


ManagedEntity . ob jectClass 


It specifies the ManagedEntity 
class name of the instances 
specified by iOCInstanceList. 


iOCInstanceList 


M 


List of <ManagedEntity . ob ject Instance> 


It specifies the DNs of 

ManagedEntity instances whose 

measurementTypes are to be 

monitored. 

At least, one instance shall be 

specified. 


thresholdlnfoList 


M 


List of 

< MeasuredAt tribute .measurementTypeName, 

Monitor . probableCause, 

Monitor . specif icProblem, 

Monitor . direction, 

thresholdPack 
> 

where thresholdPack is list of thresholdPackElement. 

The thresholdPackElement is STRUCT 

< 

ThresholdLevel . thresholdValue, 
ThresholdLevel . thresholdSeverity, 
ThresholdLevel . hysteresis, 

> 


It specifies the thresholds to 
specific measurementTypes. 
See clause 6.5.1 (definition and 
legal values). 
The number of 
ThresholdLevel in 
thresholdLevelList must 
be 1,2, 3 or 4. 


monitorGranularity 
Period 


M 


Monitor .monitorGranularityPeriod 


See clause 6.5.1 (definition and 
legal values). 



7.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monitorld 


M 


ThresholdMonitor .monitorld. 


It specifies the unique identifier of the 
ThresholdMonitor in the pmirp Agent. 


unsupported List 


M 


List of < 

ManagedEntity. ob jectClass, 

ManagedEntity .object Instance, 

MeasuredAttribute . 

measurementTypeName, 

reason 

> 


To create a ThresholdMonitor, best-effort is 
required. This parameter identifies the 
unsupported but requested 
measurementType(s). 
The reason can be: 

(a) The pmirp has trouble starting monitoring 
the threshold of this measurementType. 

(b) The measurementType is illegal. 

(c) The measurementType exists but it is not 
currently under monitoring by any 
Measurement Job and that the PMIRP 
requires that it be under monitoring by 
Measurement Job (before it can be 
monitored for thresholding). 

(d) Hysteresis is overlapped. 

This parameter is used only when the operation 
returns 'PartialSuccess'. 


status 


M 


ENUM (Success, Failure, PartialSuccess) 


An operation may fail because of a specified or 
unspecified reason. 
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7.4.1.4 



Pre-condition 



validGranularityPeriod AND someValidMeasurementType AND validDirection AND 
validNumberOf ThresholdPackElements AND validOrderOf ThresholdPackElements. 



Assertion Name 


Definition 


validGranularityPeriod 


The monitorGranularityPeriod is valid. 


someValidMeasurementType 


At least one requested measurementType can be monitored for thresholding. 


validDirection 


The direction is valid. 


validNumberOfThresholdPackElements 


If pmirp supports multi-level thresholdSeverity, it is valid if the number of 
elements in thresholdPack is 1 , 2, 3 or 4. 

If PMIRP does not support multi-level thresholdSeverity, it is valid if the 
number is 1. 


validOrderOfThresholdPackElements 


This assertion is applicable if pmirp supports multi-level thresholdSeverity. It 
is valid if it satisfies the constraint defined by multiLevelSeverityOrder of 
clause 6.5.2 (constrains). 



7.4.1.5 



Post-condition 



thresholdMonitorlsCreated AND notifyOb jectCreationEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsCreated 


The ThresholdMonitor identified by monitorld exists. And the performance alarm shall be 
emitted if the thresholds are (a) crossed or (b) reached and the thresholdMonitorStatus 
is "Active". (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
The ThresholdMonitor.thresholdMonitorStatus will be Active. 


notifyObjectCreationEmitted. 


The notifyObjectCreation is emitted to indicate the creation of a ThresholdMonitor. 



7.4.1.6 



Exceptions 



Exception Name 


Definition 


invalidClassOrlnstances 


Condition: (validClassAndlnstances) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


invalidGranularityPeriod 


Condition: (validGranularityPeriod) not verified. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


noValidMeasurementType 


Condition: (someValidMeasurementType) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidNumberOfThresholdPackE 
lements 


Condition: (validNumberOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidOrderOfThresholdPackEle 
ments 


Condition: (validOrderOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidDirection 


Condition: (validDirection) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4.2 Operation deleteThresholdMonitor (M) 
7.4.2.1 Definition 

This operation supports IRPManager's request to delete a specified ThresholdMonitor. 

At the time of the removal, all outstanding (a) threshold-crossing or (b) threshold reaching alarms will stay (i.e. the 
FMIRP Agent's AlarmList will contain an Alarmlnf ormation indicating (a) threshold-crossing or (b) threshold 
reaching). The IRPManager needs to use other means to remove the Alarmlnf ormation in the FMIRP 
AlarmList. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
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7.4.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThresholdMonitor .monitorld 


It specifies the ThresholdMonitor to be stopped and 
removed. 



7.4.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, 
Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.4.2.4 



Pre-condition 



thresholdMonitorExists. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThresholdMonitor specified in the input parameters exists. 



7.4.2.5 Post-condition 

thresholdMonitorlsDeleted AND notifyOb jectDeletionEmitted.. 



Assertion Name 


Definition 


thresholdMonitorlsDeleted 


ThresholdMonitor identified by monitorld ceases to exist. 


notifyObjectDeletionEmitted 


The notifyObjectDeletion is emitted to indicate the deletion of a ThresholdMonitor. 



7.4.2.6 



Exceptions 



Exception Name 


Definition 


unknownThresholdMonitor 


Condition: (thresholdMonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4.3 Operation NstThresholdMonitors (M) 



7.4.3.1 



Definition 



This operation supports IRPManager's request to list detailed information about all or specified 

ThresholdMonitors. 



7.4.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorldList 


M 


List of 

<ThresholdMonitor . monitor I d> 


This parameter specifies the 

ThresholdMonitors to be listed. 

If the parameter specifies the list of monitorlds, 
then the corresponding information of 
ThresholdMonitors will be returned. 

If the parameter contains no information, all the 
ThresholdMonitors in the pmirp Agent will 
be returned. 
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7.4.3.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monitorlnfoList 


M 


List of < 

attributes of ThreshoidMonitor (see 

definition and legal values in clause 6.5.1), 

iOCName, 

iOCInstanceList, 

thresholdlnfoList (See clause 7.4.1.2 input 

parameters of create thresholdMonitor 

operation) 

> 


Returned information of 
corresponding ThresholdMonitors 
matching the input criteria. If no 
match, then the length of the 
monitorlnfolist will be (with status 
== Success). 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a 
specified or unspecified reason. 



7.4.3.4 



Pre-condition 



monitor IdLi st IsValid. 



Assertion Name 


Definition 


monitorldListlsValid 


monitorldList specified in the input parameter is valid. 



7.4.3.5 



Post-condition 



thresholdMonitorsAreReturned AND thresholdsAreUnaf f ected. 



Assertion Name 


Definition 


thresholdMonitorsAre 
Returned 


The information of required ThresholdMonitors are returned in the output parameters. 


thresholdsAreUnaffected 


The ThresholdMonitors are not affected. 



7.4.3.6 



Exceptions 



Exception Name 


Definition 


invalidMonitorldList 


Condition: (monitorldListlsValid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.5 PMIRPOperations_3 Interface (O) 
7.5.1 Operation suspendThresholdMonitor (M) 



7.5.1.1 



Definition 



This operation supports IRPManager's request to suspend the ThresholdMonitor . If the operation succeed, its 
thresholdMonitorStatus shall be set to "Suspended". PMIRP shall not emit performance alarms related to this 
ThresholdMonitor. The ThresholdMonitor shall still exist. 



7.5.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThresholdMonitor .monitorld 


It specifies the ThresholdMonitor to be suspended. 
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Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.5.1.4 



Pre-condition 



thresholdMonitorExists AND thresholdMonitorlsNotSuspended. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThreshoidMonitor specified in the input parameter exists. 


thresholdMonitorlsNotSuspended 


ThreshoidMonitor specified in the input parameter is not suspended. 



7.5.1.5 Post-condition 

t hr e s ho ldMon it or Is Suspended AND not if y ThreshoidMonitor St atusChangedEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsSuspended 


The ThreshoidMonitor identified by monitorld is suspended, that 
means it will not work until it is resumed. 

The ThreshoidMonitor . thresholdMonitorStatus will be 

'Suspended'. 


notify ThresholdMonitorStatusChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted. 



7.5.1.6 Exceptions 



Exception Name 


Definition 


unknownThresholdMonitor 


Condition: (thresholdMonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMonitorAlreadySuspended 


Condition: (thresholdMonitorlsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.5.2 Operation resumeThresholdMonitor (M) 

7.5.2.1 Definition 

This operation supports IRPManager's request to resume a suspended ThreshoidMonitor . 

7.5.2.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThreshoidMonitor .monitorld 


It specifies the ThreshoidMonitor to be resumed. 



7.5.2.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 
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7.5.2.4 



Pre-condition 



thresholdMonitorExists AND thresholdMonitorlsSuspended. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThreshoidMonitor specified in the input parameter exists. 


thresholdMonitorlsSuspended 


ThreshoidMonitor specified in the input parameter is suspended. 



7.5.2.5 Post-condition 

thresholdMonitorlsResumed AND not if y ThreshoidMonitor St atusChangedEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsResumed. 


The ThreshoidMonitor identified by monitorld is resumed, that means it will work again. 

The ThreshoidMonitor. thresholdMonitorStatus will be "Active'. 


notify ThresholdMonitorStatu 
sChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted. 



7.5.2.6 



Exceptions 



Exception Name 


Definition 


unknownThresholdMonitor 


Condition: (thresholdMonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMonitorlsNotSuspended 


Condition: (thresholdMonitorlsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.6 PMIRPNotificatiorM Interface (M) 



7.6.1 



not ifyMeasurement JobS tat us Changed (M) 



7.6.1.1 



Definition 



The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a Measurement Job. The 
status changes in that case include Suspended=>Scheduled, Active=>Suspended, Scheduled=>Suspended, 
Suspended=>Active, Scheduled=>Active, Active=>Stopped, Suspended=>Stopped, Scheduled=>Stopped. 



7.6.1.2 



Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


ob jectClass 


M, Y 


PMIRP. objectClass 


Notification header - see [12]. It shall carry the 
PMIRP class name. 


object In stance 


M, Y 


PMIRP. objectlnstance 


Notification header - see [12]. It shall carry the 
DN of the PMIRP. 


eventTime 


M, Y 


-- 


Notification header - see [12]. 


not if icationType 


M, Y 


"notifyMeasurementJobStatusChanged" 


Notification header - see [12]. 


systemDN 


C, Y 


-- 


Notification header - see [12]. 


notification Id 


M, N 


-- 


Notification header - see [12]. 


jobld 


M, Y 


Measurement Job . jobld 




jobStatus 


M, N 


Measurement Job . jobStatus 


The new Status Of the Measurement Job . 


reason 


0, N 


~ 


It carries one or several of the assertion names 
of the From-state of Triggering Event. 
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7.6.1.3 



Triggering Event 



7.6.1.3.1 



From-state 



f ailToReadMeasurementTypesForExtendedProlongPeriod OR internalProblem OR 
stopMeasurement Job OR stopTimeReached OR resumeMeasurement Job OR 
suspendMeasurement Job OR startTimeReached OR suspendMeasurement JobBySystem 



Assertion Name 


Definition 


f ailToReadMeasurementTypesForExtendedProlongPeriod 


Because the pmirp Agent have failed to read the 
monitored measurementType (s) from managed 
resources for one or more times, the pmirp Agent 
decides that it will not try to read in the future and 
place the Measurement Job in "Stopped" state. 


internalProblem 


Because of an unspecified internal problem, 
pmirp Agent decides that it no longer can 
maintain the Measurement Job in any jobStatus 
but "Stopped". 


stopMeasurement Job 


The stopMeasurement Job returns success. 


stopTimeReached 


The Stop time for Measurement Job has been 
reached. 


resumeMeasurement Job 


The resumeMeasurement Job returns success. 


suspendMeasurement Job 


The suspendMeasurement Job returns success. 


startTimeReached 


The Start time for Measurement Job has been 
reached. 


suspendMeasurement JobBySystem 


The MeasurementJob has been suspended by the 
system in case of overload 



7.6.1.3.2 To-state 

measurement JobS tat us Changed 



Assertion Name 


Definition 


measurement JobS tat us Changed 


The MeasurementJob . jobStatus changed to a new value. 



7.6.2 Void 
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7.7 



PMIRPNotification_2 Interface (O) 



7.7.1 notifyThresholdMonitorObjectCreation (M) 



7.7.1.1 



Definition 



IRP Agent notifies the subscribed IRPManager that a new Monitor instance has been created and that the notification 
satisfies the filter constraint expressed in IRPManager"s subscribe operation (see TS 32.302 [12]). 



7.7.1.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


ob jectClass 


M, Y 


PMIRP.objectClass 


See Table 7.6.1.2. 


object In stance 


M, Y 


PMIRP.objectlnstance 


See Table 7.6.1.2. 


notification Id 


M. N 


-- 


See Table 7.6.1.2. 


eventTime 


M, Y 


ManagedEntity.creationTime 


See Table 7.6.1.2. 


systemDN 


C, Y 


-- 


See Table 7.6.1.2. 


not if icationType 


M, Y 


'notify ThresholdMonitorObjectCreation' 


Notification header - see [12]. 


monitorld 


M, N 


Monitor.monitored 


See monitorld definition in clause 
6.5.1. 


monitorGranularityPeriod 


M, N 


Monitor.monitorGranularityPeriod 


See monitorGranularityPeriod 
definition in clause 6.5.1. 


thresholdMonitorStatus 


M, N 


ThresholdMonitor.thresholdMonitorStatus 


See thresholdMonitorStatus 
definition in clause 6.5.1. 



7.7.1.3 



Triggering Event 



7.7.1.3.1 



From-state 



stateBef or eObject Creation. 



Assertion Name 


Definition 


stateBef oreObject Creation 


The number of instances of the IOC ManagedEntity is equal to N. 



7.7.1.3.2 



To-state 



s t at eAfterOb ject Creation. 



Assertion Name 


Definition 


st ateAfterOb ject Creation 


The number of instances of the IOC ManagedEntity is equal to N + 1 . 



7.7.2 notifyThresholdMonitorObjectDeletion (M) 



7.7.2.1 



Definition 



IRP Agent notifies the subscribed IRPManager of a deleted Monitor instance. The IRP Agent invokes this notification 
because the subject notification satisfies the filter constraint expressed in the IRPManager subscribe operation (see 
TS 32.302 [12]). 
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7.7.2.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


ob jectClass 


M, Y 


PMIRP.objectClass 


See Table 7.6.1.2. 


object Instance 


M, Y 


PMIRP.objectlnstance 


See Table 7.6.1.2. 


notification Id 


M, N 


- 


See Table 7.6.1.2. 


eventTime 


M, Y 


ManagedEntity.deletionTime 


See Table 7.6.1.2. 


systemDN 


C, Y 


-- 


See Table 7.6.1.2. 


not if icationType 


M, Y 


'notifyThresholdMonitorObjectDeletion' 


Notification header - see [12]. 


monitorld 


M, Y 


Monitor. monitored 


See monitorld definition in clause 6.5.1. 



7.7.2.3 



Triggering Event 



7.7.2.3.1 



From-state 



stateBef or eObject Deletion. 



Assertion Name 


Definition 


stat eBeforeObject Deletion 


The number of instances of the IOC ManagedEntity is equal to N. 



7.7.2.3.2 To-state 

s t at eAfterOb ject Deletion. 



Assertion Name 


Definition 


st at eAfterOb ject Deletion 


The number of instances of the IOC ManagedEntity is equal to N - 1 . 



7.7.3 notifyThresholdMonitorStatusChanged (O) 



7.7.3.1 



Definition 



The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a ThresholdMonitor. 
The status changes in that case include Suspended=>Active, Active=>Suspended. 

NOTE: The notifyThresholdMonitorStatusChanged notification is mandatory if PMIRPOperations_2 is 
supported. 



7.7.3.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


ob jectClass 


M, Y 


PMIRP.objectClass 


See Table 7.6.1.2. 


object Instance 


M, Y 


PMIRP.objectlnstance 


See Table 7.6.1.2. 


eventTime 


M, Y 


-- 


See Table 7.6.1.2. 


not if icationType 


M, Y 


"notify ThresholdMonitorStatusChanged". 


See Table 7.6.1.2. 


systemDN 


C, Y 


-- 


See Table 7.6.1.2. 


notification Id 


M, N 


-- 


See Table 7.6.1.2. 


monitorld 


M, Y 


Monitor .monitorld 




monitor St at us 


M, N 


ThresholdMonitor . thresholdMoni 
torStatus 


The new Status Of the ThresholdMonitor . 


reason 


0, N 


-- 


It carries one or several of the assertion 
names of the From-state of Triggering Event. 
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Assertion Name 


Definition 


resumeThresholdMonitor 


The resumeThresholdMonitor returns success. 


suspendThresholdMonitor 


The suspendThresholdMonitor returns success. 



7.7.3.3.2 To-state 

thresholdMonitorStatusChanged 



Assertion Name 



Definition 



thresholdMonitorStatusChanged 



The ThreshoidMonitor . threshoidMonitorStatus changed to a new value. 
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8 



Scenarios 



8.1 



createMeasurementJob 



:NM 



:IRPAqent 



createMeasurementJob 



return success 



-> 



<r- 



If schedule is reached, PMIRP Agent begins to collect the data\ 
according to the input parameters, and emit the 
notifyFileReady notification at the end of each reporting 
period, Now the jobStatus is "Active". 

notifyFileReady 



IRPManager mayget^ 



file(s) by 
Transfer 



File 
IRP. 



<r 



«e 



listMeasurementJobs( 



return required info 



^n 



IRPManager can request PMIRP t\ 
Agent to list all the jobs for the 

specified filter. 

listFilesO 



return required info 



-> 



IRPManager can request PMIRP t\ 
Agent to list all the files for a 
specified job and filter. 



Figure 8.1 : Scenariol of Performance Management 
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8.2 stopMeasurementJob 



NM 



IRPAgent 



IRPManagercan request PMIRP Agent 
to stop a specified job in any situation, 
no matter the jobStatus is "Scheduled", 
"Active" or "Suspended". 



stopMeasurementJob () 



-> 



return success 



<^ 



Figure 8.2: Scenario2 of Performance Management 
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8.3 stopMeasurementJob/listMeasurementJobs/listFiles 



:NM 



: IRPAqent 



IRPManager can request PMIRP Agent 
to stop a specified job in any situation, 
no matter the jobStatus is "Scheduled", 
"Active" or "Suspended". 



stopMeasurementJob () 



■>J 



<- 



return success 



listMeasurementJobsO 



->J 



<r 



return required info 



If the measurementJob is not 
removed, the information of stopped 
measurementJob can be returned 



MstFilesQ 



->r 



<- 



return required info 



If the files of a stopped 
measurementJob are still existing in 
the PMIRP Agent, their information can 
be returned to IRPManager if required. 



Figure 8.3: Scenario3 of Performance Management 
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8.4 suspendMeasurementJob/resumeMeasurementJob 



NM 



:IRPAqent 



IRPManager can request PMIRP Agent to 
suspend a "Scheduled" or "Active" job in 
some situation, such as high work load. 



suspendMeasurementJob() 



-^ 



return success 



<- 



If the "suspend" operation is 
successful, the jobStatus is changed 
to "Suspended" accordingly. 



IRPManager can request 
PMIRP Agent to resume 
a "Suspended" job. 



resumeMeasurementJobO 



^> 



<^ 



return success 



If the "resume" operation is 
successful, the jobStatus 
is changed to "Scheduled" 
or "Active" according to the 
job schedule. 



Figure 8.4: Scenario4 of Performance Management 
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Annex A (normative): 

Illustration of the state described in the state Diagram 

A.1 Definition of state 
A.1.1 Scheduled 

"Scheduled" means that the job has been created and the start time has not been reached. 

A.1.2 Suspended 

"Suspended" means that the job has been suspended for some reason. 

A. 1.3 Active 

"Active" means that the start time of a Measurement Job has been reached. 

There are two sub-states: "Busy" and "Idle". 

"Busy" means that the Measurement Job is monitoring the measurementTypes. 

"Idle" means that the Measurement Job is not monitoring the measurementTypes. 

When a Measurement Job becomes active, it does not mean that the job is immediately busy. IRPManager can set 
the detailed time frame (e.g. dailySchedule or weeklySchedule) for a Measurement Job to be busy. If there is no time 
frame schedule for a job, it immediately monitors the measurement types when it becomes active. 

A. 1.4 Stopped 

"Stopped" means that the Measurement Job is deleted via the Itf-N. Whether the managed system removes the 
Measurement Job immediately or later is vendor specific. 
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A.2 State transition scenarios 

The following scenarios give examples of state transitions. 



A.2.1 Scenario 1 

A Measurement Job is created at 11:00, and the startTime is 14:00, stopTime is 18:00. At 12:00, the 
Measurement Job is suspended, and at 13:00, the Measurement Job is resumed. 



job is Scheduled job is Suspended job is Scheduled job is Active 



-»k 



-***- 



-►r*- 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



suspend 
measurement job 



resume 
measurement job 



start 

time reached 



At 1 1 :00: the Measurement Job becomes scheduled after it was created. 

At 12:00: the Measurement Job is suspended and the jobStatus is "Suspended". 

At 13:00: the Measurement Job is resumed, and the jobStatus is "Scheduled" because the start time has not been 

reached. 
At 14:00: the Measurement Job becomes active because start time has been reached. 



Figure A.2.1 : Scenario 1 



A.2.2 Scenario 2 



A Measurement Job is created at 1 1:00, and the startTime is 12:00, stopTime is 18:00. At 13:00, the 
Measurement Job is suspended, and at 14:00, the Measurement Job is resumed. 



job is Scheduled 

^ : »k- 



job is Active 



-►+ 



job is Suspended 



job is Active 

► 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



start 

time reached 



suspend 
measurement job 



resume 
measurement job 



At 1 1 :00 
At 12:00 
At 13:00 
At 14:00 



the Measurement Job becomes scheduled after it was created, 
the start time is reached, and the jobStatus is "Active", 
the Measurement Job is suspended, and the jobStatus is "Suspended" 
the Measurement Job is resumed, and the jobStatus is "Active". 

Figure A.2.2: Scenario 2 
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A.2.3 Scenario 3 

A Measurement Job is created at 1 1:00 and the startTime is 12:00, stopTime is never stop. There is no other 
schedule defined. IRPManager stops the job at 14:00. 



job is Scheduled 

^ — tk- 



job is Active 



11:00 



12:00 



create 
measurement job 



start 

time reached 



13:00 



14:00 



Time 



stop 
measurement job 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is Stopped when IRPManager stops the job. 



Figure A.2.3: Scenario 3 



A.2.4 Scenario 4 



A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 14:00. There is no other schedule 
defined. 



I I 

job is Scheduled 

^ : ik- 



job is Active 



I 



-► 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



start 

time reached 



stop time reached 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is stopped automatically when stop time is reached. 

Figure A.2.4: Scenario 4 
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A.2.5 Scenario 5 

A Measurement Job is created at 1 1:00 and the startTime is 12:00, stopTime is "never stop". There is a 
dailySchedule defined, which is 13:00-14:00 and 15:00-16:00 every day. 



job is Active 



job is 



job is Busy 



'Scheduled i Job is Idle K U job is Idle I 



job is Busy 




11:00 



start 

time reached 



dailySchedule 



create 
measurement job 



At 12:00: the Measurement Job becomes active when start time has been reached. Since there is a schedule for 
the job, the job monitors measurement types only during the specified schedule. During other times, the 
job is idle. 

At 13:00 and 15:00: the Measurement Job becomes busy when the daily schedule has been reached. 

Figure A.2.5: Scenario 5 
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A.2.6 Scenario 6 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 13:30. The 

Measurement Job . granularityPeriod is 30 minutes and the Measurement Job . reportingPeriod is 1 

hour. There is no other schedule defined. 



I I 

job is Scheduled 

*!* — >k- 



job is Active and Busy 



I 



11:00 



create 
measurement job 



12:00 



start 

time reached 



13:00 



13:30 



14:00 



Time 



♦ t > — 



stop 

time reached 



file is available and a 
notifyFileReady 
notification is sent 



file is available 
and a 

notifyFileReady 
notification is sent 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no detailed time frame 

for the job, the job begins to work at the same time. 
At 13:00: the file(s) of the Measurement Job are available, and pmirp emits the notifyFileReady notification to 

subscripted IRPManager. 
At 13:30: the Measurement Job is automatically stopped when stop time is reached. 
At 14:00: pmirp will emit the last notifyFileReady notification. 

Figure A.2.6: Scenario 6 
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Annex B (normative): 

Threshold related performance alarms Triggering Events 

This annex defines the Triggering Events for the various performance alarms. The Triggering Events normally are 
defined by each notification type, such as notifyChangedAlarm, under the clause "Triggering Events". The 
Triggering Events related to thresholding are defined here collectively for ease of reference. 

The Triggering Events are defined in a state transition table. The column labels (e.g. 0, 1, 2, 3 of table in clause B.l) 
denote the to-state while the row labels denote the from-state. The cell denotes the emission action. 

There are two clauses. Clause B.l defines the Triggering Events for IRP Agent that supports 
notifyChangedAlarm. Clause B.2 defines those for IRPAgent that does not support notifyChangedAlarm. 

Clause B.3 provides samples of triggering events. 



B.1 IRPAgent supporting notifyChangedAlarm 

Table B.1 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


From 
State-4 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 



The horizontal '0', T, '2', '3' and 4' are the to-states indicating the current measurementType value with respect to the 
different threshold levels. Threshold levels are associated with severity level (thresholdSeverity). Higher threshold level 
associates with higher severity level (thresholdSeverity). 

EXAMPLE: If direction = Increasing', state-0 means the measurementType value is below all thresholds. 
State-2 means that the measurementType value is above threshold level 2 but below threshold 
level 3. If direction = 'Decreasing', state-0 means the measurementType value is above all 
thresholds. State-2 means that the measurementType value is below threshold level 2 but above 
threshold level 3. 

The vertical '0', T, '2", '3' and 4' are the from-states indicating the last-read measurementType value with respect to the 
threshold levels. 

A threshold has a value and may have a hysteresis. A threshold with hysteresis has a threshold-high value and a 
threshold-low value that are different from the threshold value. A threshold without hysteresis can be considered as a 
threshold whose threshold-high and threshold-low values are equal to the threshold value. 

For the direction = Increasing', the shaded cells indicate transitions caused by measurementType values (a) rising 
across or (b) reach one or more threshold-high values. The non-shaded cells indicate transition caused by 
measurementType values falling across one or more threshold-low values. 

For the direction = 'Decreasing', the shaded cells indicate transitions caused by measurementType values (a) falling 
across or (b) reach one or more threshold-low values. The non-shaded cells indicate transition caused by 
measurementType values rising across one or more threshold-high values. 

Each cell indicates the performance alarm emission when from-state transits to to-state. The notifyNewAlarm and 
notifyChangedAlarm shall carry the severity level (perceivedSeverity) associated with the to-state 
(thresholdSeverity). 
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The ThresholdMonitor determines, at monitorGP=X, if a threshold has been (a) crossed or (b) reached by 
comparing the value read at monitorGP==X with the value read at monitorGP==X-l. In initial condition (i.e. when the 
ThresholdMonitor reads the value at monitorGP=l), the (hypothetical) value read at monitorGP==X-l is assumed to be 
at state-0. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 



B.2 IRPAgent not supporting notifyChangedAlarm 

Table B.2 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


To State-4 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 



The Monitor determines, at monitorGP=X, if a threshold has been crossed by comparing the value read at monitorGP 
==X with the value read at monitorGP ==X-1. In initial condition (i.e. when the Monitor reads the value at monitorGP 
= 1), the (hypothetical) value read at monitorGP ==X-1 is assumed to be at state-0. 



B.3 Examples 
B.3.1 Example 1 

Figure B.3.1 illustrates multi-level thresholdSeverity thresholding behaviour. The horizontal axis indicates the time 
intervals specified by the Monitor .monitorGranularityPeriod (monitorGP). The vertical axis indicates the 
monitored measurementType values. The measurementType of this example is of type gauge. The 
Monitor . direction is set to "Increasing". 

Further suppose that the measurementType is monitored for a (a) two-level-severity-threshold-crossings or (b) two- 
level-severity-threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the lower-level-severity is set to 3 with a hysteresis low and high levels set to 2 and 4 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Minor. 

The threshold for the higher-level-severity is set to 7 with a hysteresis low and high levels set to 6 and 8 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Major. 

The performance alarm triggering events are: 

1. At monitorGP interval 3, trigger a notifyNewAlarm with perceivedSeverity (ps) = Minor. 

2. At monitorGP interval 5, if the IRPAgent supports notifyChangedAlarm, trigger a 
notifyChangedAlarm with ps = Major; else a notif yClearAlarm and a notifyNewAlarm with ps 
= Major. 

3. At monitorGP interval 8, if the IRPAgent supports notifyChangedAlarm, trigger a 
notifyChangedAlarm with ps = Minor; else a notifyClearAlarm and a notifyNewAlarm with ps 
= Minor. 

4. At monitorGP interval 15, trigger a notifyClearedAlarm clearing the last emitted Minor alarm. 
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Thresholding behavior for direction Increasing for Gauge type PMAttribute 




2 3 4 5 6 7 8 9 10 1 1 12 13 14 15 

Threshold Granularity Period time intervals 

Figure B.3.1 



B.3.2 Example 2 



Figure B.3.2 illustrates another multi-level thresholdSeverity thresholding behaviour for IRP Agent supporting 
notif yChangedAlarm. The horizontal axis indicates the time intervals specified by the GP. The vertical axis 
indicates the monitored measurementType values. The measurementType of this example is of type gauge. The 
Monitor . direction is set to "Decreasing". 

Further suppose that the measurementType is monitored for a two-level thresholdSeverity (a) threshold-crossing or (b) 
threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the major-level thresholdSeverity is set to 7 with a hysteresis high and low levels set to 6 and 8 
respectively. 

The threshold for the minor-level thresholdSeverity is set to 9 with a hysteresis high and low levels set to 8 and 10 
respectively. 

The performance alarm triggering events are: 

1. At monitorGP interval 1, trigger a notifyNewAlarm with ps = Major. See table B.l table for transition 
State-0 to State -2. 

2. At monitorGP interval 5, trigger a notifyChangedAlarm with ps = Minor. See table B.l for transition 
State-2 to State- 1. 

3. At monitorGP interval 8, trigger a notifyChangedAlarm with ps = Major. See table B.l for transition 
State- 1 to State-2. 
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Thresholding behavior for direction Decreasing for Gauge type PMAttribute 




5 6 7 8 9 10 11 

Threshold Granularity Period time intervals 



Figure B.3.2 



B.3.3 Example 3 



Figure B.3.3 illustrates a single-level thresholding behaviour. The horizontal axis indicates the time intervals specified 
by the monitorGP. The vertical axis indicates the monitored measurementType values. The measurementType of this 
example is of type gauge. The Monitor . direction is set to "Increasing". 

The threshold is set to 4 with a hysteresis high and low levels set to 5 and 3 respectively. The thresholdSeverity level is 
Critical. 

The performance alarm triggering events are: 

1. At monitorGP interval 3, trigger a notifyNewAlarm with ps = Critical. 

2. At monitorGP interval 11, trigger a notifyClearedAlarm withps = Cleared. 

Hysteresis at 4 with high and low 
level set at 5 and 3 respectively 



Thresholding behavior with hysteresis 




5 6 7 8 9 10 11 

Threshold granularity period time intervals 

Figure B.3.3 
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